<>-- Dragon from Succubus Valley --<>
(DfSV / Succubus Heart) By : spirit Shard

<> What is the 'Dragon from Succubus Valley' mod? <>
Dragon from Succubus Valley (DfSV for short) is a mod focused on integrating sex with progression. With DfSV installed the player will have the abilities of a life force stealing Succubus! Players will increase stats through sexual activity and be able to sacrifice those stats in order to level up and unlock new skills/spells.


<> Story <>
[spoiler]
<> Dragon from Succubus Valley - Character Story <>
Two rival nations battling for the last of their precious pets. The Succubus army of Blood Heart takes on full assault into Casting Glaze, or as it's known to the humans, Succubus Valley. A lone Succubus resident rises from their victim's body as they hear the gates shatter - they are here for humans. The lone Succubus rushes on her way to warn the commander but is stopped by a large Blood Heart force. "It's over Moon Heart, we're taking them all!" Her once victim dragged alongside her as they headed for the shattered metal gates gives out a whisper, "You... You can help.." The Succubus looks down on the ragged man but is quickly surprised by a glow in his hand, "Help my... my homeland..." In a quick dash of light the man stands as destruction circles the two dragged prisoners, "THIS IS OUR FREEDOM."

The succubus wakes up in the middle of a castle surrounded by what appears to be.. humans? Delighted as she is, it's not long before she's tied up and put into a cell. "Oh well, at least they mistake me for some dragonborn hero."


<> Story - Succubus <>
The Succubus is a creature who gains power through the consumption of souls and Life Force, and the easiest way to get them is through.. oh, you know.. ^.-[/spoiler]


<> Mechanics <>
Succubus Blessing
--- Increase Max Health/Stamina/Magicka with sexual activities
--- Max Health/Stamina/Magicka will degrade over time
--- Sacrifice Max Health/Stamina/Magicka to level up
--- Consume delicious sperm for some extra delight
--- Absorb Max Health/Stamina/Magicka from others during Sex
--- [Planned] Sacrifice stats to summon powerful power spells
--- [Planned] Use the power of sperm to conjure destruction
--- [Planned] If you've got the focus, overpower your foes with suduction spells
--- [Possible?] Talk your way to the bedroom with seductive language (Seductive Dialogue)

Heart System
--- Heart Focus system, use this to increase Succubus Spell effects.
--- Obtain HeartXP through sexual activities
--- Spend this HeartXP on advancing your skills
--- Spend HeartXP to expand your succubus powers and learn new spells/seductive ways

Built on SexLab Framework
--- Any sexlab animations will work with this mod

[WIP] MCM, DfSV - Succubus Heart
--- Spend your points and level skills using the MCM
--- [WIP] Manage settings through the MCM
--- [Planned] Full Help section for references

[Possible?] Dragon from Incubus Canyon
--- [Possible?] Play through the mod with all aspects geared toward a male protagonist (NOTE : current version works for males, just a little strange)

[Possible?] Sperm Trader
[Possible?] SexLab Arousal integration?
[Possible?] "Succubus Heart" Quest Line
[Possible?] Include code so that other mods can trigger HeartXP and effect Heart Force

<> Small planned update stuff <>
- Fill out the "Help" page with descriptions
- Additional Spells for combat and seduction
- A lot of little things
- Release V1.0.0


<> Requirements <>
- SKSE 1.07.01 [ http://skse.silverlock.org/ ]
--- It may run on an older version but this is what I worked with.
-Sexlab v159c [ http://www.loverslab...dated-oct-3rd/ ]
--- Or higher I assume


<> Strongly Recommended Mods <>
- Skyrim -Community- Uncapper [ http://www.nexusmods...im/mods/1175/? ]
--- For uncapping the level caps and adjusting leveling to accommodate for the new progression options.
- Defeat V5b3.3+ [ http://www.loverslab...5b33fixed-805/ ]
--- Allows for a whole array of rape and such, plus the tie-up feature really helps out in big fights, or just to let your pet wait a little longer for pleasure. ^.-


<> 'just' Recommended Mods <>
- More Nasty Critters [ http://www.loverslab...asty-critters/ ]
--- Large collection and additions to bestiality mods - a must have in my opinion.
- Sexlab Aroused Redux [ http://www.loverslab...aroused-redux/ ]
--- Just because


<> Recommended Settings <>
()> Skyrim -Community- Uncapper <()
I've provided an ini settings file as optional in order to set a little balance. This file contains a few changes...
-- Increased Caps to 999
-- Skill Multipliers are set at 0.4


<> Compatibility <>
- Conflicts with mods that "lock" stats or increase/decrease them to maintain a specific value, luckly these mods are very rare since there's really no reason to do this..
- Compatibility with PSQ is beginning to be questionable
- If you find anything else please let me know!

<> Known Issues <>
- Status Values are shown in float (ex. 100.000000)
--- This has no negative effect, it's just not visually appealing
- Heart Focus will go above cap by a small amount if the player is experiencing a lot of script lag, nothing I can really do about this and it doesn't seem to have negative effects.


<> Installation / Updating <>
Merge the provided Data folder with your skyrim install, install 'Optional Uncap' if so desired. Enable in your mod manager of choice.

WARNING : If you used a version before V0.5.0 it is recommended to start a new save when updating. I've fixed an issue that could have "broken" saves. Of course a clean save should suffice, mechanics have changed enough a new save may be warranted anyways.

<> SPECIAL NOTE <>
The soul burn spells were removed in V0.5.0, if you wish you can delete the files as following..
DfSV_SoulBurnH.pex
DfSV_SoulBurnHI.pex
DfSV_SoulBurnHII.pex
DfSV_SoulBurnM.pex
DfSV_SoulBurnMI.pex
DfSV_SoulBurnMII.pex
DfSV_SoulBurnS.pex
DfSV_SoulBurnSI.pex
DfSV_SoulBurnSII.pex
located in [skyrim install]/data/scripts/
Also delete the same named files under [skyrim install]/data/scripts/source 


<> FAQ <>
[spoiler]
<> Q and A <>
Q : What does Heart Force do? [V0.6.0]
A : Heart Force is used for Succubus Spells and determines Seduction effectiveness

Q : Why does my character always seem to have XXX health/magicka/stamina?
A : In this mod the succubus gains status when having sex but will lose those gains over time, you'll need to continue sexual activities to keep higher status, may I suggest keeping extra sperm on you? The rate is 1/5sec, this will be made an optional feature in a future release. The minimum is calculated by 100 + 10/per level.

<> Spells <>
[Heart] Focus Shot
--- Consumes 10% of your current Heart Force and damages the target by that amount. 50% of that goes into HeartXP.
[/spoiler]

<> Change Log <>
[spoiler]
- V0.6.0
--- Heart Force usage changed
--- Heart Force will now be used only for spells and seduction attempts
--- Heart Force is no longer lost during sexual activity
--- Heart Force no longer effects gains/losses during sexual activity
--- New Spell "Force Shot" Added (find it under the Heart Spells MCM)
--- The minimum Health/Magicka/Stamina a player can have before decay is now increased with each player level (100 + 10/per level)
--- Skill Levels are now shown in the Soul Burn MCM (The page must be re-selected for changes to show)
--- Absorb Values are now shown in the Status MCM
--- Sperm values are now shown in the Status MCM
--- *Adjusted* sex type effects (As aggressor - 100% / As Consensual - 60% / As Victim - 10%)
--- *Fixed* Sperm not increasing status by the proper values
--- *Fixed* HeartXP Gain not increasing properly and decaying on some events
--- *Fixed* Heart Gain MCM not increasing properly
--- *Fixed* More improper values (when there's so many lines of code it's easy to miss things X.x)

- V0.5.2
--- Fixed improper labels
--- Minor check adjustments

- V0.5.1
--- The "HeartXP" options should now show a confirmation window like with skills
--- *fixed* being unable to level anything in the HeartXP page
--- *fixed* obsessive damage after sex (should now currently check with only 1 health damage. Reminder, if your partner only has 1 health remaining he/she will die, a more complex death check may be released in the next version)

- V0.5.0 [New Game is recommended - clean save may be enough]
--- Pretty much re-wrote everything
--- Large balance update (changed all values)
--- Changed Lowest Health/Magicka/Stamina the player can have to 20 (So be careful!)
--- The player now decay Health/Magicka/Stamina when over 100
--- Added in Gender Checks (Females should no longer give sperm)
--- All females should now receive sperm when there is a male partner
--- Sperm count increases when multiple males are present in the animation (there's still a chance someone will go dry tho!)
--- Partner Harm now implemented (for victims/aggressors, consensual harm will be available in a later update, the amount is determined by the character's absorption rates)
--- "Status" is now viewable in the Soul Burn MCM (Health/Magic/Energy/HeartXP)
--- High and Low Heart Focus now effect absorption and HeartXP gain at fixed amounts ( 150% on high and 50% on low )
--- You can now increase Absorption rate of Health/Magicka/Stamina in the MCM with HeartXP
--- You can now increase HeartXP gain in the MCM with HeartXP (a little ironic, I know)
--- You can now increase sperm effects in the MCM
--- A lot of "under the hood" improvements
--- *Removed* "Uninstall" option until I learn how to add it properly
--- *Removed* "Random Knowledge" Soul Burn effect
--- *Removed* "Soul Burn" Spells from .esp (they were outdated and not available by normal means anyway)
--- *Altered* Optional uncapper options (contains skills uncapped to 999 and skill multi at 0.4 for balance concerns)
--- *fixed* an issue with script updates and broken saves
--- *fixed/removed* "I feel a little weak..." debug spam when Heart Force is low
--- *fixed* females giving sperm
--- *Fix* Sperm's "Succubus Delight" effect now only works on the player as intended

- V0.4.1
--- [hopefully] Fixed Heart Force getting 'stuck' under zero
--- Fixed "Feeling a little weak..." from spamming console even when Heart Force isn't low
--- "Status" Screen now shows appropriate values (still in float form tho)

- V0.4.0 [Clean Save Required]
--- MCM menu has been added! (DfSV - Succubus heart)
--- New Status Menu Page in MCM
--- Soul Burn now available through MCM
--- Can now level individual skills at increased cost
--- Can now Increase Carry Weight just like a Skill
--- Added New HeartXP Mechanic (gained through sexual activity)
--- You can now spend HeartXP for individual skill ups
--- Added New Heart Force Mechanic (this replaces the plan for stamina effects to avoid conflicts with other mods)
--- Heart Force passively regenerates but decreases through sexual activity
--- You can now increase Max Heart Force and the regen rate of Heart Force with HeartXP
--- Heart Force now effects the benefits of sexual activity (being raped will lower it quicker than raping another)
--- Added a "player submit" effect for when the player is victim
--- Added chances to get a large load of sperm, or a dry run...
--- *Fixed* compatibility issue with health/stamina/magicka buffs
--- Added an "Uninstall" option under settings to stop quest scripts after uninstallations (doesn't work fully)
--- *Adjusted* optional uncapper settings
--- *Removed* Soul Burn spells from quest start-up (You can still find them using the console since they may return but their effects have not been updated to align with the new MCM options)
--- NOTE : Spells will be added as an option in the MCM on a later update if requested enough

- V0.2.0 [Clean Save Required]
--- SexLab Integration
--- Removed the need for SexLabUtil1 (if you were using V0.1.3 please disable the DfSV settings in SexLabUtil1)
--- With SexLabUtil1 gone there are no longer any required settings before play, just install and go!
--- Player now Gain stats during sex
--- Player now Gains bonus stats for being an Aggressor
--- Added Visuals to the "Soul Burn" skills (still lacks casting effect and menu image)
--- Sperm is now efficiently added (no more double sperm gain!)
--- *Broke* harm to opponent durring sex (you can use SexLabUtil1 if this is a needed feature)
--- *Adjusted* Sperm stat values (now that you gain stats during sex)
--- *Adjusted* and fixed a few Soul Burn effects (May need further adjustments)
--- *Adjusted* Optional uncapper settings to be closer to vanilla (now only uncaps all skills to 999 and reduces level multipliers to 0.8)

- V0.1.3
--- Concept Release
[/spoiler]

If you guys/gals have any ideas or want to help go ahead and say so! I'm fairly new to Papyrus so there's quite a bit I can learn and I'm always looking for new ideas.

Happy Hunting!